home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / uucp / wcnews_1_0_30.lha / man / rnews.man < prev    next >
Text File  |  1994-01-04  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. RNEWS(8)                                                 RNEWS(8)
  5.  
  6.  
  7. ›1mNAME›22m
  8.        rnews, cunbatch - accept and spool news input
  9.        newsspool, newsrun, c7decode - news input spooler and pro­
  10.        cessing
  11.        newsrunning - control news­processing daemon
  12.  
  13. ›1mSYNOPSIS›22m
  14.        ›1mrnews›22m
  15.        ›1mcunbatch›22m
  16.        ›1m/usr/lib/newsbin/input/newsspool›22m [ ›1m-i›22m ] [ file ... ]
  17.        ›1m/usr/lib/newsbin/input/newsrun›22m
  18.        ›1m/usr/lib/newsbin/input/c7decode›22m
  19.        ›1m/usr/lib/newsbin/input/newsrunning›22m [›1mon›22m|›1moff›22m]
  20.  
  21. ›1mDESCRIPTION›22m
  22.        ›4mRnews›24m accepts news from standard input and  spools  it  up
  23.        for  processing,  space  permitting.   If space is persis­
  24.        tently   too   short,   ›4mrnews›24m   looks   for    the    file
  25.        ›4m/usr/lib/news/rnews.stall›24m;  if  it is present, ›4mrnews›24m waits
  26.        patiently for more space to appear, while if it is absent,
  27.        ›4mrnews›24m discards the news and reports this.
  28.  
  29.  
  30.        ›4mCunbatch›24m  is  a  historical synonym for ›4mrnews›24m; there is no
  31.        difference in what they do.
  32.  
  33.        ›4mNewsspool›24m is the actual spooling program.   It  creates  a
  34.        spool  file  with  a name based on the current time (which
  35.        avoids the need for locking)  in  the  spooling  directory
  36.        ›4m/usr/spool/news/in.coming›24m  and  copies  the  input ›4mfile›24m(s)
  37.        (standard input default) to it, stripping off any `›1m#!›22m ›1mcun­›22m
  38.        ›1mbatch›22m' or `›1m#!›22m ›1mc7unbatch›22m' header as it does so.  If invoked
  39.        with the ›1m-i›22m option, when finished  it  attempts  to  start
  40.        ›4mnewsrun›24m  to  process  the  new  news  immediately.   ›4mRnews›24m
  41.        invokes  it  this  way   if   and   only   if   the   file
  42.        ›4m/usr/lib/news/rnews.immed›24m exists.
  43.  
  44.        ›4mNewsrun›24m  should  be  run periodically (e.g. by ›4mcron›24m(8)) to
  45.        process spooled news.  ›4mNewsrunning›24m can  be  used  to  turn
  46.        ›4mnewsrun›24m's  processing off and on if it is desired to avoid
  47.        major news processing during certain hours.   `›1mnewsrunning›22m
  48.        ›1moff›22m'  instructs  any  currently­running ›4mnewsrun›24m to stop as
  49.        soon as possible, and prevents later  ones  from  running.
  50.        `›1mnewsrunning›22m  ›1mon›22m'  removes  the  inhibition  (but does not
  51.        actually start a new ›4mnewsrun›24m).  Without an argument, ›4mnews­›24m
  52.        ›4mrunning›24m reports the current status: ``off'' or ``on''.
  53.  
  54.        ›4mNewsrun›24m checks for the ›4mstop›24m file that ›4mnewsrunning›24m ›4moff›24m cre­
  55.        ates, verifies that there is enough disk  space  for  pro­
  56.        cessing,  and  then  starts processing spooled news.  Each
  57.        batch is run through ›4mc7decode›24m (if necessary), de›4mcompress›24med
  58.        (if  necessary), and then fed to ›4mrelaynews›24m (on the server,
  59.        if ›4m/usr/lib/news/server›24m exists and contains its name).  If
  60.        ›4mrelaynews›24m  fails, ›4mnewsrun›24m reports this (by mail to ›1musenet›22m)
  61.  
  62.  
  63.  
  64.                            13 Dec 1990                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RNEWS(8)                                                 RNEWS(8)
  71.  
  72.  
  73.        and attempts to save the spooled batch in the  ›4mbad›24m  subdi­
  74.        rectory  for  human inspection.  To bound the accumulation
  75.        in ›4mbad›24m in the event of some  systematic  problem,  ›4mnewsrun›24m
  76.        limits  ›4mbad›24m  to  50  files; this default can be changed by
  77.        placing a ›4mlimit›24m file in ›4mbad›24m,  containing  one  ASCII  line
  78.        with the desired numeric limit.  A limit of 0 will prevent
  79.        saving of bad batches.
  80.  
  81.        ›4mC7decode›24m passes standard input to standard output,  decod­
  82.        ing a complex and bizarre encoding of 8­bit data as print­
  83.        able ASCII characters.
  84.  
  85. ›1mFILES›22m
  86.        (All in ›4m/usr/spool/news/in.coming›24m)
  87.  
  88.        000000000 (etc.) spooled news
  89.        stop      ›4mnewsrun›24m disable file
  90.        bad       directory for failed news
  91.        bad/limit limit on number of files in ›4mbad›24m
  92.  
  93. ›1mSEE›22m ›1mALSO›22m
  94.        compress(1), newsbatch(8), newsmail(8), relaynews(8)
  95.  
  96. ›1mDIAGNOSTICS›22m
  97.        Complaints are mailed to ›1musenet›22m if something goes wrong.
  98.  
  99. ›1mHISTORY›22m
  100.        Part of C News.  Written at University of Toronto by Henry
  101.        Spencer.
  102.  
  103. ›1mBUGS›22m
  104.        ›4mC7decode›24m should be part of the underlying transport mecha­
  105.        nism.  It hasn't been tested very well in the C News envi­
  106.        ronment.  ›4mBdecode›24m (see ›4mnewsmail›24m(8)) is probably better for
  107.        most uses.
  108.  
  109.        ›4mRelaynews›24m  is  a  bit  too  enthusiastic  about  declaring
  110.        batches  bad, so things end up in ›4mbad›24m for no terribly good
  111.        reason.  Actually, it's rare for the contents of ›4mbad›24m to be
  112.        very interesting.
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                            13 Dec 1990                          2
  131.  
  132.  
  133.